home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / graphics / spriv102.zip / SPRIV102.DOC < prev   
Text File  |  1994-12-21  |  19KB  |  303 lines
  1. ┌─────────────────────────────────────────────────────────────────────────────┐
  2. │                       SPRITER V1.02 Beta                                    │
  3. └─────────────────────────────────────────────────────────────────────────────┘
  4. ╔═════════════════════════════════════════════════════════════════════════════╗
  5. ║ Spriter Manual By Dimitri Smits, author of SPRITER                    01/06 ║
  6. ╚═════════════════════════════════════════════════════════════════════════════╝
  7.  
  8. TABEL OF CONTENTS                                                            01
  9.  
  10. Disclaimer ................................................................. 02
  11. Why? ....................................................................... 02
  12. What this proggy does ...................................................... 03
  13. FeedBackWare? What's that? ................................................. 04
  14. BugReports (Please help me to improve) ;) .................................. 04
  15. How to get in touch with the author ........................................ 05
  16. Insecabilis, never heard of (you should be ashamed ;)), who are they? ...... 05
  17. What to expect in future versions .......................................... 05
  18. Credits .................................................................... 06
  19. IGA - Format ............................................................... 06
  20.  
  21. ╔═════════════════════════════════════════════════════════════════════════════╗
  22. ║ Spriter Manual By Dimitri Smits, author of SPRITER                    02/06 ║
  23. ╚═════════════════════════════════════════════════════════════════════════════╝
  24. ╔═════════════════════════════════════════════════════════════════════════════╗
  25. ║ Disclaimer (Sorry, but this is necessary!)                                  ║
  26. ╚═════════════════════════════════════════════════════════════════════════════╝
  27.         The author of this program is not liable for any damage to the
  28.         computer on which this programm will run or has run, nor for any loss
  29.         of DATA whatsoever. The author claims not to have put in any Virusses
  30.         ,Worms, Trojans, or anything else damaging or threatening your compu.
  31.         When this program was first released, it did NOT have anything in it
  32.         (except for drawing routines, mouse routines, and input/output routines
  33.         for managing files).If you have any trouble whatsoever with the program
  34.         you may report it to me, but you MUST remember that the program was
  35.         provided AS IS! Maybe (IF its a bug in the program) I will look after
  36.         it. If You DON'T like this, then DELETE EVERYTHING NOW!
  37.  
  38. ╔═════════════════════════════════════════════════════════════════════════════╗
  39. ║ Why?                                                                        ║
  40. ╚════╤══════╤═════════════════════════════════════════════════════════════════╝
  41.      └┐ Why?└┐ Well I started programming last Mai,(in pure TP 7.0 of course)
  42.       └──────┘ and wanted to create something 'BIG'. Since I had started, all
  43.         of my proggy's stayed under 10K source (when you know that TP compiles
  44.         5K anyhow, you might know that those proggy's wheren't that awesome
  45.         at all ;)), so I thought that I should do something BIG and worthwhile
  46.         (on how to code proggy's in TPascal), yet interesting and pulicly
  47.         appealing. Since there are MANY, MANY ;) trackers available, I figured
  48.         that the world wasn't waiting for another MOD-proggy (with respect
  49.         to all other existing sound-module formats around) and therefore I
  50.         wanted to make something about graphics (the real reason is that I
  51.         don't understand SH*T about music) and then I started wondering about
  52.         what subject ... and came up with a program that could generate an
  53.         array of bytes for screen purposes (more commonly known as sprites &
  54.         fonts) because I wondered where the people on the DEMOScene got there
  55.         marvellous fonts & drawings (I know now (when I'm (or was) writing
  56.         this text) that the use PCX-files or BMP's or GIF's or ...) and
  57.         started meditating on how to accomplish that and what other features
  58.         there would have to be to distinguish it from other drawing-programms
  59.         and came up with an ICONdraw-routine. Well, since then I have learned
  60.         a bit of assembler (a lot actually, but not enough to go fully ASM)
  61.         which I implemented in some routines. This program is not the fastest
  62.         smallest, low in memory use, best coolest proggy ever, but I like my
  63.         first real program and will continue on making it better and optimizing
  64.         the code, as soon I see that there is need to continue.
  65.         The (only) reason why I don't release my sourcecode is that I am a
  66.         bit ashamed by the way it looks, its unoptimizedness (or something like
  67.         that, I know:bad english :)), it being undocumented and hard to follow
  68.         as anyone could expect for a first release of a source of 64K.
  69.         So don't worry, I'm working on a new project now and am rewriting a
  70.         big part of the program. If you want to know what the project is, read
  71.         on in What to expect in future versions.
  72.  
  73. ╔═════════════════════════════════════════════════════════════════════════════╗
  74. ║ Spriter Manual By Dimitri Smits, author of SPRITER                    03/06 ║
  75. ╚═════════════════════════════════════════════════════════════════════════════╝
  76. ╔═════════════════════════════════════════════════════════════════════════════╗
  77. ║ What this proggy does   (or is supposed to do)                              ║
  78. ╚═════════════════════════════════════════════════════════════════════════════╝
  79.         It's a drawing proggy to draw sprites,fonts(libs of sprites) & ICONs.
  80.         It also produces files in I(nsecabilis)G(raphics)A(rray)-format.
  81.         It is not my intention to give a complete overview of it's functions,
  82.         because I have to get up early tomorrow, but here is an explanation
  83.         about getting started:
  84.  
  85. ┌A────────────────────────────┐ ┌B────────────┐ ┌C──────────────────────────┐
  86. │                             │ │  32 * 32    │ │       CREDIT TO ME        │
  87. │      32 * 32 raster         │ │   pixels    │ │            +              │
  88. │                             │ │ the result  │ │    TITLE PROGRAM & VERS   │
  89. │                             │ │ in mode 13H │ ├S───────────┬T─────────────┤
  90. │      Here you draw your     │ │ 320*200*256 │ │IN-FileName │Out-FileName  │
  91. │         pictures            │ └─┬U─┬─┬V─┬───┘ └────────────┴──────────────┘
  92. │                             │ ┌D└──┴─┴──┴─────────────────────────────────┐
  93. │                             │ │ Message Box                               │
  94. │                             │ │                                           │
  95. │                             │ │ ┌───────────────────────────────────────┐ │
  96. │                             │ │ └─Path──────────────────────────────────┘ │
  97. └─────────────────────────────┘ └───────────────────────────────────────────┘
  98. ┌E─────┬F─────┐   ┌N┐ ┌O───────────────────────────────────┐┌P──────────────┐
  99. │ SAVE │ LOAD │BAR├─┤ │                                    ││               │
  100. ├G─────┼H─────┤   │ │ │        256 COLORS                  │├Q──────────────┤
  101. │ QUIT │ SIZE │   │ │ │                                    ││               │
  102. └──────┴──────┘┌M─│ │ │                                    │├───────────────┤
  103.   Actual Pict >│NR│ │ │                                    ││               │
  104. ┌I─────┬J─────┐└──┤ │ │                                    ││ SAVE INFO     │
  105. │CLEAR │ COPY │   │ │ │                                    ││               │
  106. ├K─────┼L─────┤   │ │ │                                    │├R──────────────┤
  107. │PASTE │ CUT  │   ├─┤ │                                    ││               │
  108. └──────┴──────┘   └N┘ └────────────────────────────────────┘└───────────────┘
  109.  
  110. A => A 32*32 (4pixel*4pixel)-raster in which you can draw your sprites
  111.      leftbutton=U, rightbutton=V, middlebutton=0 (erase)
  112. B => along with A, you get to see the result Real-Size
  113. C => just filling
  114. D => here is where you get to see errors (Disk I/O (file not found, ...))
  115.      also there is a bar with a path-string, which you can alter
  116. E => this saves according to the T extension in IGA-format or ICO-format
  117.      if the extension is IGA, the program will use P,Q,R to know what to save
  118.      so, when you want to save something, FIRST check if the settings in P,Q,R
  119.      are the ones you would like to use for your saving.
  120. F => this LOADs into memory from the Picture you are on (M) onwards 'til
  121.      everything is loaded (when you load a lib from a position, but when the
  122.      lib contains more than 60-M, it will start at the beginning again (M=1)
  123.      when it reaches 61)
  124. G => Obvious not?!?
  125. H => has only effect on P and Q variables
  126. I => clears current picture defined by M
  127. J => makes a copy of everything in the P & Q variables to a clipboard
  128. K => gets the clipboard to the current picture and fills it from X1 Y1, defined
  129.      in P & Q
  130. L => Cuts everything within the range of the P & Q variables
  131.  
  132. ╔═════════════════════════════════════════════════════════════════════════════╗
  133. ║ Spriter Manual By Dimitri Smits, author of SPRITER                    04/06 ║
  134. ╚═════════════════════════════════════════════════════════════════════════════╝
  135. M => points to current position,by leftclicking the mouse on it, you can change
  136.      directly to a specified picture (which will alter A & B as well)
  137. N => 2 arrows used by clicking on it to alter the position in picture array
  138.      indirectly changes M and thus A & B also
  139.      leftclick=1 at a time, rightclick=keep pressed to alter till you artive
  140.      where you want to be
  141. O => colours of palette,which is available
  142.      leftclicking on them will alter U
  143.      rightclicking on them will alter V
  144.      remember that when you want to change an ICON, you MAY ONLY USE colors
  145.      0 TO 15 (line 1 in O)
  146. P & Q => topleft till bottomright + X-axis & Y-axis length to (cut,copy,...)
  147. R => from which picture till which picture to save
  148. S => name inputfile
  149. T => name outputfile
  150. U => color left
  151. V => color right
  152.  
  153. ╔═════════════════════════════════════════════════════════════════════════════╗
  154. ║ FeedBackWare? What is that?                                                 ║
  155. ╚═════════════════════════════════════════════════════════════════════════════╝
  156.         It's a name I gave this 'system' of Public Domain I use.
  157. When you want to use this program, you will get my permission, but what you
  158. will have to do is put EVERYTHING you made using this program on the PUBLIC
  159. DOMAIN. Also, I want YOU to send me an E-Mail to my Internet address(see below)
  160. (now I'll finally get some mail! hint! hint!) in which you will give me an idea
  161. of what you think about SPRITER, and also on which Internet (FTP-site) I will
  162. be able to find your GFX and how to get there.
  163. If you have any comments or bugreports or ideas or ...,whatever,please send it
  164. to me, I'll try to respond as soon as possible.
  165.         So, in a nutshell: FeedBackWare is:
  166. You Download SPRITER, which you may use and copy IF:
  167.         - YOU send me E-Mail
  168.         - YOU notice me where/how I can find your work done with my program
  169.         - You send me MONEY, WOMEN, A PENTIUM,... ;) (only if you feel like it)
  170.         - You give me some feedback on the proggy, so it will become better
  171.         - You put your work on the public domain
  172.         - When you use any of these GFX for a production, please give credit
  173.           to me (Dimitri Smits or Discordis / Insecabilis) and the artist
  174.           who made the library if it wasn't you).
  175.     - Upload your creations to ftp.eng.ufl.edu in dir /demos/graphics/
  176.         utils/iga (or look for a directory IGA to put it in)    
  177. If your work is GOOD, it will be included in a next version of SPRITER with
  178. credits to your work.
  179. If your tips prove usefull, you are also on the road to fame, because you
  180. will be mentioned hardcoded in the proggy.
  181.  
  182. ╔═════════════════════════════════════════════════════════════════════════════╗
  183. ║ Bugreports                                                                  ║
  184. ╚═════════════════════════════════════════════════════════════════════════════╝
  185.         - When you type in a name, (especially path) its quite possible that
  186.         you see as if nothing happened , well it probably didn't
  187.         - I dont get the right palette for the ICONS ( so if you know, send it
  188.       to me, please!)
  189.         - after altering anything in R, the red Square is gone
  190.     - program uses KeybScancodes -> the character displayed may be or not
  191.       be the one you expected to type, so watch out what you type
  192.       (this will be fixed in one of the next releases)
  193. Maybe (read: probably) these will be fixed in another version
  194.  
  195. ╔═════════════════════════════════════════════════════════════════════════════╗
  196. ║ Spriter Manual By Dimitri Smits, author of SPRITER                    05/06 ║
  197. ╚═════════════════════════════════════════════════════════════════════════════╝
  198. ╔═════════════════════════════════════════════════════════════════════════════╗
  199. ║ How to get in touch with the author?                                        ║
  200. ╚═════════════════════════════════════════════════════════════════════════════╝
  201. About Spriter
  202. Via E-Mail:
  203.         Internet:
  204.                send to: dsmits@zorro.ruca.ua.ac.be
  205.                                 ^^^-> hey,don't lauch, I didn't choose its name
  206.            if about spriter       subscribe: Discordis.IGA
  207.            anything else (e.g. application for GFX artist)
  208.                         subscribe: INSECABILIS
  209.  
  210. Via Snail Mail:
  211.         send to: Discordis/Insecabilis
  212.                  Paulus Beyestraat 91
  213.                  2100 Deurne (BELGIUM)
  214. Where to put your .IGA files: on ftp.eng.ufl.edu in /demos/graphics/utils/iga/
  215.  
  216. ╔═════════════════════════════════════════════════════════════════════════════╗
  217. ║ Insecabilis? Never heard of! Who are they?                                  ║
  218. ╚═════════════════════════════════════════════════════════════════════════════╝
  219.         Insecabilis is the name of a Demo/Intro/Game group I am trying to
  220.         start. At the moment of this writing, there are 3 members
  221.                 Dimitri Smits (Discordis): CODER
  222.                 Benjamin De Hondt        : MUSICIAN (has his own CD out in a
  223.                                            couple of months)
  224.                 Ben Verpoorten           : CODER
  225.  
  226.         If YOU are intersted in 'working' for a group such as ours, please
  227.         contact me, I won't lauch (I'd probably do worse if I tried anyway).
  228.         So, if you are a 'GOOD' GFX-artist, a 'GOOD' musician or a 'GOOD'
  229.         CODER (preferably capable of writing his Sourcecode in TP7.0 (with
  230.         ASM-based subroutines) and able to create a musicsystem for 8CHN
  231.         MODS(or something)) PLEASE send us some of your work, or tell us
  232.         where to find it (on Internet) and we 'll take a look at it.
  233.         We are (at least not for now) not yet into commercial demos, becoz
  234.         we want to learn to code better and have more efficiency first,
  235.         maybe we will in a 'near' FUTURE.
  236.  
  237. ╔════════════════════════════════════════════════════════════════════════════╗
  238. ║ What to expect in future releases                                          ║
  239. ╚════════════════════════════════════════════════════════════════════════════╝
  240.         - more than 32 * 32 piccy's
  241.         - more than 60 piccy's
  242.         - a paletteroutine for getting better control over what you draw
  243.         - a text-font editor (draw binary fonts for use in text modes)
  244.                 (how to implement that, will be explained then)
  245.         - faster routines
  246.         - full TP7.0 *.PAS sourcecode (no TPU's -> .PAS) with documentation
  247.         - examples
  248.         - fileselection routines (you wouldn't have to know where,what file is)
  249.         - many, many things more 
  250.         - if you have any ideas, get in touch. I'll add them to this list
  251.           and will implement them sooner or later.
  252.     - another palette possible (boy, everyone hates green nowadays!;)
  253.  
  254. ╔═════════════════════════════════════════════════════════════════════════════╗
  255. ║ Spriter Manual By Dimitri Smits, author of SPRITER                    06/06 ║
  256. ╚═════════════════════════════════════════════════════════════════════════════╝
  257. ╔═════════════════════════════════════════════════════════════════════════════╗
  258. ║ Credits                                                                     ║
  259. ╚═════════════════════════════════════════════════════════════════════════════╝
  260. Dimitri Smits for coding & ideas
  261. Benjamin De Hondt for Beta-testing
  262. Steven Smits for Beat-testing
  263. Ellen Smits for Beta testing
  264. Guy Hofkens for Mouse-Routines (Partially)
  265. Dirk Schippers / A.P.E.X. for giving me ideas and learning me to program
  266.   WITHOUT BGI's and a beginning of ASM-coding (implemented in TP)
  267. ...
  268.  
  269. ╔═════════════════════════════════════════════════════════════════════════════╗
  270. ║ IGA-Format                                                                  ║
  271. ╚═════════════════════════════════════════════════════════════════════════════╝
  272.       ┌ BYTE ─┬──────── DESCRIPTION ───────────────────────────────────┐
  273.       │1 to 3 │ IGA (header)                                           │
  274.       ├───────┼────────────────────────────────────────────────────────┤
  275.     * │   4   │ Version this file was made with  (1.??,2.??,...)       │
  276.       ├───────┼────────────────────────────────────────────────────────┤
  277.       │   5   │ number of piccy's in FILE                              │
  278.       ├───────┼────────────────────────────────────────────────────────┤
  279.       │   6   │ Y-axis of each piccy (set for all)                     │
  280.       ├───────┼────────────────────────────────────────────────────────┤
  281.       │   7   │ X-axis of each piccy (set for all)                     │
  282.       ├───────┼────────────────────────────────────────────────────────┤
  283.       │   8   │ number times (y times (x pixels))                      │
  284.       .   .   .                                                        .
  285.       .   .   .                                                        .
  286.       └────────────────────────────────────────────────────────────────┘
  287. * Note that the versionnumber will serve in the future, because simplistic
  288. compressing will be implemented from one of the next versions on.
  289.  
  290. ╔═════════════════════════════════════════════════════════════════════════════╗
  291. ║ Last Minute Note                                                            ║
  292. ╚═════════════════════════════════════════════════════════════════════════════╝
  293.    This Package should be spread totally, without changes, and should contain
  294.    the following files:        
  295.     SPRIV102.DOC  you are reading this
  296.         SPRIHIST.INS  history file
  297.         SPRITER.DAT   DATA-file for SPRITER
  298.         SPRITER.EXE   SPRITER, the executable
  299.         FILE_ID.DIZ   description-file
  300.     PALETTE.PAL   palette-file (if you make another palette, this won't
  301.               change the palette in the program, but if your palette
  302.               is better, you may always send it in)
  303.